|
|
DMEndConfigureDisplays |
||||
| Header: | Displays.h | Carbon status: | Supported | |
Ends configuration begun by DMBeginConfigureDisplays. You should generally never need to use this function.
OSErr DMEndConfigureDisplays (
Handle displayState
);
Supply this parameter with the handle obtained by the DMBeginConfigureDisplays function.
A result code.
The function DMEndConfigureDisplays resumes Display Manager configuration checking, the rebuilding of desktop regions, and Apple event notification of Display Manager changes, all of which are postponed when you use the function DMBeginConfigureDisplays. Your application will then receive a single Display Notice event notifying your application of Display Manager changes, and your application can manage its windows accordingly.
Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.
Applications generally never need to use this function. In case you find a compelling need to change the user’s display configuration, this function is described here for completeness. Note that if your application uses Display Manager functions to change the display configuration of the user’s video devices, your application should make these changes only with the consent of the user. If your application must have a specific pixel depth, for example, it should display a dialog box that offers the user a choice between changing to that depth or canceling display of the image.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)